home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / hldtos11.zip / HOLDTOSS.DOC < prev    next >
Text File  |  1990-05-20  |  6KB  |  159 lines
  1.  
  2.                              HoldToss v1.1
  3.                 Hold specified NetMail messages from tossing
  4.                      (c) 1990 - Serious Cybernetics
  5.                       written by - C. Scott Davis
  6.  
  7. ------------------------------------------------------------------------------
  8.  
  9.  The following files should be included in HLDTOS11.ZIP :
  10.  
  11.  HOLDTOSS.EXE
  12.  HOLDTOSS.CNF
  13.  HOLDTOSS.DOC
  14.  
  15. -----------------------------------------------------------------------------
  16.  
  17.  HOLDTOSS is a program written to allow sysops to maintain their personal
  18.  Netmail messages in a "Fido Style" message base and toss the others into
  19.  their BBS. This once again will allow users of the BBS to recieve NetMail.
  20.  
  21.   HoldToss can be run one of several ways :
  22.  
  23.  HOLDTOSS    (no parameters) will hold specified messages,
  24.               run the tossing program, and release the held messages.
  25.                            (Normal operation)
  26.  
  27.  HOLDTOSS -h  (hold) will hold the specified messages (but will
  28.               NOT run the tossing program). You can then run the tossing
  29.               program (or perform any other actions) and then run HoldToss -r
  30.               (release), which will release the held messages.
  31.  
  32.  HOLDTOSS -r  (release) will release all held messages without
  33.               running the tossing program. It will also renumber your
  34.               messages (if specified in .cnf file)
  35.  
  36.  HOLDTOSS -t  (test) will test the HoldToss.cnf file for errors.
  37.  
  38. -------------------------------------------------------------------------------
  39.  
  40.                             HOLDTOSS.CNF
  41.  
  42. HOLDTOSS gets the information it needs to determine which messages to hold (as
  43. well as other control specifications, such as high message, NetMail directory,
  44. etc.) from the HOLDTOSS.CNF configuration file.
  45.  
  46. The following variables may be defined in HOLDTOSS.CNF :
  47.  
  48. "himsg="    defines the highest message to check. (default 250)
  49. "tossparm=" parameters to be passed to the toss program. (default NONE)
  50. "renum="    determines if messages are to be renumbered or not. (default OFF)
  51. "lastread=" determines if the lastread file is to be updated. (default OFF)
  52.  
  53. If a variable is ommitted, HoldToss will assume a default value.
  54. If a variable is defined more than once, each definition will replace any
  55. earlier definition.
  56.  
  57. The following are "special" variables & MUST be defined :
  58.  
  59. "netdir="   defines the NetMail directory to use.
  60. "tossprog=" defines the name of the tossing program (must include extension).
  61. "holdto="   lists the usernames to hold NetMail to (up to 100).
  62. "holdfrom=" lists the usernames to hold NetMail from (up to 100).
  63.  
  64. If the "netdir=" variable is ommited or is invalid, Holdtoss will exit
  65. with an errorlevel of 3 & NO mail will be tossed.
  66.  
  67. The "tossprog=" variable is ommited, HoldToss will exit with an errorlevel of
  68. 4 & obviously no mail will be tossed.
  69.  
  70. The "holdto=" & "holdfrom=" variables should only have one name specified
  71. on each line. If both of these variable are omited HoldToss will exit with
  72. an errorlevel of 5 & NO mail will be tossed.
  73.  
  74.                 See the HOLDTOSS.CNF file for examples.
  75.  
  76. ------------------------------------------------------------------------------
  77.  
  78. HOLDTOSS ? displays this screen:
  79.  
  80. Usage : HOLDTOSS [option]
  81.  
  82. where option is one of :
  83.  
  84.    ? will display help
  85.    ! will display information
  86.   -t will test HOLDTOSS.CNF
  87.   -h will HOLD messages only (tossing program will not be run)
  88.   -r will RELEASE messages only (tossing program will not be run)
  89.  
  90. Errorlevel 0 = Operation successful
  91. Errorlevel 1 = Help/version info displayed or configuration test run
  92. Errorlevel 2 = Invalid parameter
  93. Errorlevel 3 = Invalid or missing NETDIR variable in HOLDTOSS.CNF
  94. Errorlevel 4 = Missing TOSSPROG variable in HOLDTOSS.CNF
  95. Errorlevel 5 = No usernames specified to HOLDTO or HOLDFROM in HOLDTOSS.CNF
  96. Errorlevel 6 = No message files found
  97.  
  98. -----------------------------------------------------------------------------
  99.  
  100.                              ***  NOTES  ***
  101.  
  102. This program has been extensively tested on systems running the D'Bridge and
  103. Frontdoor mailers under QuickBBS. It should work for virtually any
  104. configuration but TEST IT FIRST!
  105.  
  106. HOLDTOSS.EXE & HOLDTOSS.CNF should be located in the same directory that you
  107. run your NetMail tosser from.
  108.  
  109. -----------------------------------------------------------------------------
  110.  
  111.                    ***  Now, the Important Stuff  ***
  112.  
  113. HOLDTOSS is shareware. You may copy and distribute HLDTOS11.ZIP freely.
  114. All I ask is that you include all of the original files, unmodified.
  115. HOLDTOSS is in NO way "crippled". I dissaprove of "Crippleware". I feel
  116. that there are still honest people in the world. If you like HoldToss and
  117. use it, any donation would be greatly appreciated ( $10 suggested ). This
  118. would help to encourage future enhancements to this program and the writing
  119. of others like it.
  120.  
  121. Questions, comments, and suggestions are welcome.
  122.  
  123. Send E/Mail to   Scott Davis
  124.                  Phoenix Starfighter BBS (2400 bps)
  125.                  Phone (404) 869-3410
  126.                  FidoNet Node 1:3616/20
  127.  
  128. Send US Mail to  Scott Davis
  129.                  Rt. 2 Box 95
  130.                  County Line Drive
  131.                  Lula, GA 30554
  132.  
  133.  
  134. Sysops, feel free to File Request the latest version of HoldToss.
  135. We will always have only the latest version available, under the
  136. magic name: HOLDTOSS
  137.  
  138. 3616/20 Phoenix Starfighter BBS 3/12/2400
  139. 3616/1  Ed's Place BBS  12/24/9600/14.4 HST
  140.  
  141. -------------------------------------------------------------------------------
  142.  
  143. I'd like to thank Danny Sosebee (Sysop of Phoenix Starfighter) for allowing
  144. me to use his BBS as a way to receive suggestions and comments regarding
  145. HoldToss. Also, I'd like to thank Ed Ivey (Sysop of Ed's Place BBS -
  146. (404)532-1978 - FidoNet Node 1:3616/1) for encouraging (at times, practically
  147. *begging*) me to write HoldToss, for painstaking beta testing and for his
  148. continued support and assistance in distributing my little software "projects".
  149.  
  150. -------------------------------------------------------------------------------
  151.  
  152.                      ***  Credit Where Credit is Due  ***
  153.  
  154. QuickBBS (tm) is a trademark of Ultimate Software Technologies Inc.
  155. D'Bridge (tm) is a trademark of Chris Irwin
  156. Frontdoor (tm) is a trademark of Joaquim Homrighausen
  157.  
  158.                         Documentation by Ed Ivey
  159.